Object and Type
Object : FCList
Type : Method
Prototype
Public Sub ReplaceByIndex(ByRef index As Variant, ByRef item As Variant)
Description
This method replaces items in a list with the specified item. Index can be an integer or a list of integers. If index is an integer, only that item is replaced. If index is a list, the list is a list of integers specifying which items to replaced. Lists are zero based. This means the index to the first item is 0, the second is 1, etc.
Parameters
Parameter Name Required? Description
index Yes Integer or list of items to replace.
item Yes Item to substitute into the list.
Error Codes
Value Meaning
4 Cannot add an element of this type to a list. List contains data of a different type.
6 Item of a type not supported.
9 Index out of range for list.
10 List for replace must be of type integer or long.
11 Index for replace must be of type integer or long.
Example
This example shows items being replaced in list1, first by single index, and then by a list.
Visual Basic:
The code in this example is written in Visual Basic.
Dim list1 As New FCList
Dim list2 As New FCList
list1.AppendItem "a", "b", "c", "d", "e", "f", "g", "h", "i"
list1.ReplaceByIndex 2, "x"
' list1 now contains "a", "b", "x", "d", "e", "f", "g", "h", "i"
list2.AppendItem 3, 5, 0
list1.ReplaceByIndex list2, "y"
' list1 now contains "y", "b", "x", "y", "e", "y", "g", "h", "i"